Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRSetViewCurrentTime

You can use the QTVRSetViewCurrentTime function to set the time in the current view.

OSErr QTVRSetViewCurrentTime (QTVRInstance qtvr, TimeValue time);
qtvr
An instance of a QuickTime VR movie.
time
The desired time in the current view.
function result
A result code.

DESCRIPTION

The QTVRSetViewCurrentTime function sets the current time in the current view of the object node specified by the qtvr parameter to the value specified by the time parameter. That value should be greater than or equal to 0 and less than or equal to the value returned by the QTVRGetCurrentViewDuration function.

QTVRSetViewCurrentTime returns the result code timeNotInViewErr if the specified time value is greater than or equal to the view duration of the specified object node; in addition, QTVRSetViewCurrentTime sets the current view time to 1 less than the view duration. Similarly, QTVRSetViewCurrentTime returns the result code timeNotInViewErr if the specified time value is less than 0; in that case, QTVRSetViewCurrentTime sets the current view time to 0.

SPECIAL CONSIDERATIONS

QTVRSetViewCurrentTime is valid only for object nodes.

SEE ALSO

Use QTVRGetViewCurrentTime [link] to get the current time of an object node.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |